home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3b / killpg.z / killpg
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. KKKKIIIILLLLLLLLPPPPGGGG((((3333BBBB))))                                                          KKKKIIIILLLLLLLLPPPPGGGG((((3333BBBB))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      killpg - send signal to a process group (4.3BSD)
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssiiiiggggnnnnaaaallll....hhhh>>>>
  13.  
  14.      iiiinnnntttt kkkkiiiillllllllppppgggg((((ppppiiiidddd____tttt ppppggggrrrrpppp,,,, iiiinnnntttt ssssiiiigggg))));;;;
  15.  
  16.      To use any of the BSD signal routines (_k_i_l_l(3B), _k_i_l_l_p_g(3B),
  17.      _s_i_g_b_l_o_c_k(3B), _s_i_g_n_a_l(3B), _s_i_g_p_a_u_s_e(3B), _s_i_g_s_e_t_m_a_s_k(3B), _s_i_g_s_t_a_c_k(2B),
  18.      _s_i_g_v_e_c(3B)) you must either
  19.  
  20.      1) #define ____BBBBSSSSDDDD____SSSSIIIIGGGGNNNNAAAALLLLSSSS or ____BBBBSSSSDDDD____CCCCOOOOMMMMPPPPAAAATTTT before including <_s_i_g_n_a_l._h>, or
  21.  
  22.      2) specify one of them in the compile command or makefile:
  23.  
  24.           cc -D_BSD_SIGNALS -o prog prog.c
  25.  
  26.  
  27. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.      _k_i_l_l_p_g sends the signal _s_i_g to the process group _p_g_r_p.  See _s_i_g_v_e_c(3B)
  29.      for a list of signals.
  30.  
  31.      The sending process and members of the process group must have the same
  32.      effective user ID, or the sender must be the super-user.  As a single
  33.      special case the continue signal SSSSIIIIGGGGCCCCOOOONNNNTTTT may be sent to any process that
  34.      is a descendant of the current process.
  35.  
  36. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  37.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  38.      of -1 is returned and the global variable _e_r_r_n_o is set to indicate the
  39.      error.
  40.  
  41. EEEERRRRRRRROOOORRRRSSSS
  42.      _k_i_l_l_p_g will fail and no signal will be sent if any of the following
  43.      occur:
  44.  
  45.      [EINVAL]       _S_i_g is not a valid signal number.
  46.  
  47.      [ESRCH]        No process can be found in the process group specified by
  48.                     _p_g_r_p.
  49.  
  50.      [ESRCH]        The process group was given as 0 but the sending process
  51.                     does not have a process group.
  52.  
  53.      [EPERM]        The sending process is not the super-user and one or more
  54.                     of the target processes has an effective user ID different
  55.                     from that of the sending process.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. KKKKIIIILLLLLLLLPPPPGGGG((((3333BBBB))))                                                          KKKKIIIILLLLLLLLPPPPGGGG((((3333BBBB))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      kill(3B), getpgrp(2), sigvec(3B)
  76.  
  77. WWWWAAAARRRRNNNNIIIINNNNGGGG ((((IIIIRRRRIIIIXXXX))))
  78.      The 4.3BSD and System V signal facilities have different semantics.
  79.      Using both facilities in the same program is ssssttttrrrroooonnnnggggllllyyyy ddddiiiissssccccoooouuuurrrraaaaggggeeeedddd and
  80.      will result in unpredictable behavior.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.